Contexto global
ShowQueryBox
Disponible desde la versión 8.3.3.
Sintaxis:
ShowQueryBox(<NotifyDescriptionOnCompletion>, <QueryText>, <Buttons>, <Timeout>, <DefaultButton>, <Title>, <TimeoutButton>)
Parámetros:
<NotifyDescriptionOnCompletion> (obligatorio)
Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará después de que se cierre la ventana de entrada de valores con los siguientes parámetros:
- <QuestionResult> – selección del usuario: valor de enumeración del sistema o un valor relacionado con un botón pulsado. Si se cierra un diálogo por tiempo de espera, el valor es Timeout,
- <AdditionalParameters> – el valor especificado cuando se crea el objeto CallbackDescription.
<QueryText> (obligatorio)
Tipo: String, FormattedString.
Texto de la consulta que se envía.
<Buttons> (obligatorio)
Tipo: QuestionDialogMode, ValueList.
Define el contenido y el texto de los botones del diálogo, y los valores vinculados a los botones.
Al usar el tipo ValueList:
- Value – contiene el valor vinculado al botón. Este valor se devuelve cuando se selecciona el botón. Se pueden usar un valor de DialogReturnCode y otros valores de enumeración como valor;
- Presentation – especifica el texto del botón. Si no se especifica la presentación y se utiliza un valor de enumeración de DialogReturnCode, se utiliza la presentación estándar;
- Picture – no se utiliza (debe estar vacío);
- Check – no se utiliza (debe estar vacío).
Al usar el tipo ValueList, la lista no debe estar vacía.
<Timeout> (opcional)
Tipo: Number.
Período en segundos que el sistema esperará una respuesta. Cuando este período expire, se cerrará el cuadro de consulta. Si no se indica el parámetro, entonces el tiempo de inactividad es ilimitado.
Si el parámetro tiene un valor negativo, se generará una excepción.
Valor predeterminado: 0.
<DefaultButton> (opcional)
Tipo: Arbitrario.
Define un botón por defecto por un tipo de botón o por el valor vinculado a él.
<Title> (opcional)
Tipo: String.
Contiene el título de la ventana de pregunta.
Si no se establece, no se mostrará el título del cuadro de diálogo.
<TimeoutButton> (opcional)
Tipo: Arbitrario.
Define el botón (por el tipo de botón o por el valor vinculado a él) en el que se muestra el número de segundos restantes hasta que expire el tiempo de espera.
Valor devuelto:
La opción seleccionada por el usuario se pasa al método especificado en el parámetro <NotifyDescriptionOnCompletion>.
Descripción:
Muestra un cuadro de diálogo de pregunta y no espera la respuesta del usuario.
Disponibilidad:
Cliente ligero, cliente web, cliente móvil, cliente grueso, aplicación móvil (cliente).
Ejemplo:
Modo = QuestionDialogMode.YesNo; Notificación = Nuevo CallbackDescription(“AfterQueryClose”, ThisObject, Parámetros); ShowQueryBox(Notificación, “¿Desea continuar?”, Modo, 0); //… &EnCliente //… |
Consulte también:
Contexto global, método ShowMessageBox
Disponible desde:
Disponible desde la versión 8.3.3.
Descripción cambiada en la versión 8.3.22.